Skip to main content

Create a new withdrawal

POST - https://url.base/api/withdrawal/payphone/new
Endpoint to create a new withdrawal. To create a new withdrawal request, the request must be built with the following parameters.
(*) Required Information.
FieldTypeDescription
*amountDecimalTransaction amount
*document_idStringBeneficiary's identity document
*beneficiaryNameStringBeneficiary's full name
*beneficiaryLastNameStringBeneficiary's last name
*beneficiaryEmailStringBeneficiary's Email
*beneficiaryPhoneStringBeneficiary's phone number and Where the money will be transferred, example of number: (5930958602222)
*accountTypeStringBank account type is (C) to clients
*dataStringIdentifier of the Withdrawal to associate. The "data" field must be unique and non-repetitive.
*confirmationURLLinkURL for transaction confirmation
*currencyStringISO currency code # Countries and currencies​
*countryStringInternational country format # Countries and currencies​​
*signStringThe signature of the parameters is unique for each transaction
info

Once the user has completed the withdrawal process, ProntoPaga will return the data to the URL you specified in the urlConfirmation

Response OK

{
"uid" : [string] // Withdrawal identifier in the system,
"status" : [string] // withdrawal status,
"data" : [string] // Additional transaction data
}

Withdrawal status Payphone

StatusDescripción
SuccessRequest Approved
CanceledRequest Reject Learn about the types of cancelled withdrawals
info

Payphone only uses the 'success' and 'canceled' statuses since these are instant payments

Status response

FieldDescription
200 - 201: OKWithdrawal created successfully
401: UnauthorizedPermission denied